<?xml version="1.0" encoding="iso-8859-1" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content=
    "application/xhtml+xml; charset=iso-8859-1" />
    <title>
      GTK+-2.24.32
    </title>
    <link rel="stylesheet" type="text/css" href="../stylesheets/lfs.css" />
    <meta name="generator" content="DocBook XSL Stylesheets V1.78.1" />
    <link rel="stylesheet" href="../stylesheets/lfs-print.css" type=
    "text/css" media="print" />
  </head>
  <body class="blfs" id="blfs-2020-04-02">
    <div class="navheader">
      <h4>
        Beyond Linux<sup>�</sup> From Scratch <span class="phrase">(System
        V</span> Edition) - Version 2020-04-02
      </h4>
      <h3>
        Chapter&nbsp;25.&nbsp;X Libraries
      </h3>
      <ul>
        <li class="prev">
          <a accesskey="p" href="goffice010.html" title=
          "GOffice-0.10.46">Prev</a>
          <p>
            GOffice-0.10.46
          </p>
        </li>
        <li class="next">
          <a accesskey="n" href="gtk3.html" title="GTK+-3.24.16">Next</a>
          <p>
            GTK+-3.24.16
          </p>
        </li>
        <li class="up">
          <a accesskey="u" href="lib.html" title=
          "Chapter&nbsp;25.&nbsp;X Libraries">Up</a>
        </li>
        <li class="home">
          <a accesskey="h" href="../index.html" title=
          "Beyond Linux� From Scratch     (System V Edition) - Version 2020-04-02">
          Home</a>
        </li>
      </ul>
    </div>
    <div class="sect1" lang="en" xml:lang="en">
      <h1 class="sect1">
        <a id="gtk2" name="gtk2"></a>GTK+-2.24.32
      </h1>
      <div class="package" lang="en" xml:lang="en">
        <h2 class="sect2">
          Introduction to GTK+ 2
        </h2>
        <p>
          The <span class="application">GTK+ 2</span> package contains
          libraries used for creating graphical user interfaces for
          applications.
        </p>
        <p>
          This package is known to build and work properly using an LFS-9.1
          platform.
        </p>
        <h3>
          Package Information
        </h3>
        <div class="itemizedlist">
          <ul class="compact">
            <li class="listitem">
              <p>
                Download (HTTP): <a class="ulink" href=
                "http://ftp.gnome.org/pub/gnome/sources/gtk+/2.24/gtk+-2.24.32.tar.xz">
                http://ftp.gnome.org/pub/gnome/sources/gtk+/2.24/gtk+-2.24.32.tar.xz</a>
              </p>
            </li>
            <li class="listitem">
              <p>
                Download (FTP): <a class="ulink" href=
                "ftp://ftp.gnome.org/pub/gnome/sources/gtk+/2.24/gtk+-2.24.32.tar.xz">
                ftp://ftp.gnome.org/pub/gnome/sources/gtk+/2.24/gtk+-2.24.32.tar.xz</a>
              </p>
            </li>
            <li class="listitem">
              <p>
                Download MD5 sum: d5742aa42275203a499b59b4c382a784
              </p>
            </li>
            <li class="listitem">
              <p>
                Download size: 12 MB
              </p>
            </li>
            <li class="listitem">
              <p>
                Estimated disk space required: 275 MB
              </p>
            </li>
            <li class="listitem">
              <p>
                Estimated build time: 1.0 SBU (using parallelism=4; add 0.1
                SBU for tests)
              </p>
            </li>
          </ul>
        </div>
        <h3>
          GTK+ 2 Dependencies
        </h3>
        <h4>
          Required
        </h4>
        <p class="required">
          <a class="xref" href="atk.html" title="ATK-2.34.1">ATK-2.34.1</a>,
          <a class="xref" href="gdk-pixbuf.html" title=
          "gdk-pixbuf-2.40.0">gdk-pixbuf-2.40.0</a> and <a class="xref" href=
          "pango.html" title="Pango-1.44.7">Pango-1.44.7</a>
        </p>
        <h4>
          Recommended
        </h4>
        <p class="recommended">
          <a class="xref" href="hicolor-icon-theme.html" title=
          "hicolor-icon-theme-0.17">hicolor-icon-theme-0.17</a>
        </p>
        <h4>
          Optional
        </h4>
        <p class="optional">
          <a class="xref" href="../pst/cups.html" title=
          "Cups-2.3.1">Cups-2.3.1</a>, <a class="xref" href=
          "../pst/docbook-utils.html" title=
          "DocBook-utils-0.6.14">DocBook-utils-0.6.14</a>, <a class="xref"
          href="gnome-themes-extra.html" title=
          "gnome-themes-extra-3.28">gnome-themes-extra-3.28</a> (runtime, for
          Adwaita and HighContrast themes), <a class="xref" href=
          "../general/gobject-introspection.html" title=
          "gobject-introspection-1.64.0">gobject-introspection-1.64.0</a> and
          <a class="xref" href="../general/gtk-doc.html" title=
          "GTK-Doc-1.32">GTK-Doc-1.32</a>
        </p>
        <div class="admon note">
          <img alt="[Note]" src="../images/note.png" />
          <h3>
            Note
          </h3>
          <p>
            If <a class="xref" href="../general/gobject-introspection.html"
            title=
            "gobject-introspection-1.64.0">gobject-introspection-1.64.0</a>
            was installed after <a class="xref" href="atk.html" title=
            "ATK-2.34.1">ATK-2.34.1</a>, <a class="xref" href=
            "gdk-pixbuf.html" title=
            "gdk-pixbuf-2.40.0">gdk-pixbuf-2.40.0</a>, and/or <a class="xref"
            href="pango.html" title="Pango-1.44.7">Pango-1.44.7</a>, those
            packages will have to be rebuilt before this package can be
            built.
          </p>
        </div>
        <p class="usernotes">
          User Notes: <a class="ulink" href=
          "http://wiki.linuxfromscratch.org/blfs/wiki/gtk+2">http://wiki.linuxfromscratch.org/blfs/wiki/gtk+2</a>
        </p>
      </div>
      <div class="installation" lang="en" xml:lang="en">
        <h2 class="sect2">
          Installation of GTK+ 2
        </h2>
        <p>
          Install <span class="application">GTK+ 2</span> by running the
          following commands:
        </p>
        <pre class="userinput">
<kbd class="command">sed -e 's#l \(gtk-.*\).sgml#&amp; -o \1#' \
    -i docs/{faq,tutorial}/Makefile.in      &amp;&amp;

./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;

make</kbd>
</pre>
        <p>
          To test the results, issue: <span class="command"><strong>make
          check</strong></span>. Note that you must run the tests from a
          session with X Window Display capability (i.e., not a text-based
          terminal/console) as the tests attempt to open an X window, and the
          tests can take an excessively long time. Using an X Window, the
          tests should take less than 0.3 SBU. One test,
          DefaultValues/GdkPixbuf, is known to fail.
        </p>
        <p>
          Now, as the <code class="systemitem">root</code> user:
        </p>
        <pre class="root">
<kbd class="command">make install</kbd>
</pre>
        <div class="admon note">
          <img alt="[Note]" src="../images/note.png" />
          <h3>
            Note
          </h3>
          <p>
            If you installed the package on to your system using a
            <span class="quote">&ldquo;<span class=
            "quote">DESTDIR</span>&rdquo;</span> method, an important file
            was not installed and must be copied and/or generated. Generate
            it using the following command as the <code class=
            "systemitem">root</code> user:
          </p>
          <pre class="root">
<kbd class="command">gtk-query-immodules-2.0 --update-cache</kbd>
</pre>
        </div>
      </div>
      <div class="commands" lang="en" xml:lang="en">
        <h2 class="sect2">
          Command Explanations
        </h2>
        <p>
          <span class="command"><strong>sed -i 's#l \(gtk-.*\).sgml#&amp; -o
          \1#' docs/{faq,tutorial}/Makefile.in</strong></span>: If you have
          <a class="xref" href="../pst/docbook-utils.html" title=
          "DocBook-utils-0.6.14">DocBook-utils-0.6.14</a> installed
          (specifically, if configure finds <span class=
          "command"><strong>db2html</strong></span>) then it will try to use
          it to rebuild some of its HTML documentation and fail due to bugs
          in some of the <code class="filename">Makefile</code>s. This
          <span class="command"><strong>sed</strong></span> fixes the
          <code class="filename">Makefile</code>s.
        </p>
        <p>
          <code class="option">--enable-gtk-doc</code>: Use this parameter if
          <span class="application">GTK-Doc</span> is installed and you wish
          to rebuild and install the API documentation.
        </p>
      </div>
      <div class="configuration" lang="en" xml:lang="en">
        <h2 class="sect2">
          Configuring GTK+ 2
        </h2>
        <div class="sect3" lang="en" xml:lang="en">
          <h3 class="sect3">
            <a id="gtk2-config" name="gtk2-config"></a>
          </h3>
          <h4 class="title">
            <a id="gtk2-config" name="gtk2-config"></a>Config Files
          </h4>
          <p>
            <code class="filename">~/.gtkrc-2.0</code>, <code class=
            "filename">/etc/gtk-2.0/gtkrc</code>, and <code class=
            "filename">/usr/share/gtk-2.0/gtkrc</code>
          </p>
        </div>
        <div class="sect3" lang="en" xml:lang="en">
          <h3 class="sect3"></h3>
          <h4 class="title">
            <a id="idm140006431671968" name=
            "idm140006431671968"></a>Configuration Information
          </h4>
          <p>
            <span class="application">GTK+ 2</span> themes change the way a
            <span class="application">GTK+ 2</span> application looks. A
            <span class="application">GTK+ 2</span> icon theme can be used to
            change the icons that appear on the application's toolbar. If you
            have installed a <span class="application">GTK+ 2</span> theme
            (such as <a class="xref" href="gnome-themes-extra.html" title=
            "gnome-themes-extra-3.28">gnome-themes-extra-3.28</a> or
            <a class="xref" href="gtk-engines.html" title=
            "GTK Engines-2.20.2">GTK Engines-2.20.2</a>), a <span class=
            "application">GTK+</span> icon theme (such as <a class="xref"
            href="adwaita-icon-theme.html" title=
            "adwaita-icon-theme-3.36.0">adwaita-icon-theme-3.36.0</a>) you
            can set your preferences in <code class=
            "filename">~/.gtkrc-2.0</code>:
          </p>
          <pre class="userinput">
<kbd class="command">cat &gt; ~/.gtkrc-2.0 &lt;&lt; "EOF"
<code class="literal">include "/usr/share/themes/<em class=
"replaceable"><code>Glider</code></em>/gtk-2.0/gtkrc"
gtk-icon-theme-name = "<em class=
"replaceable"><code>hicolor</code></em>"</code>
EOF</kbd>
</pre>
          <p>
            There are many more themes available at <a class="ulink" href=
            "http://gnome-look.org/">Gnome-Look.org</a> and other places.
          </p>
          <p>
            Once you've settled on themes you like, you can (as the
            <code class="systemitem">root</code> user) make them the default
            system wide:
          </p>
          <pre class="root">
<kbd class="command">cat &gt; /etc/gtk-2.0/gtkrc &lt;&lt; "EOF"
<code class="literal">include "/usr/share/themes/<em class=
"replaceable"><code>Clearlooks</code></em>/gtk-2.0/gtkrc"
gtk-icon-theme-name = "<em class=
"replaceable"><code>elementary</code></em>"</code>
EOF</kbd>
</pre>
          <p>
            <a class="xref" href="../lxde/lxappearance.html" title=
            "LXAppearance-0.6.3">LXAppearance-0.6.3</a> is a <span class=
            "application">GTK+ 2</span> application that can help you choose
            the themes you like.
          </p>
        </div>
      </div>
      <div class="content" lang="en" xml:lang="en">
        <h2 class="sect2">
          Contents
        </h2>
        <div class="segmentedlist">
          <div class="seglistitem">
            <div class="seg">
              <strong class="segtitle">Installed Programs:</strong>
              <span class="segbody">gtk-builder-convert, gtk-demo,
              gtk-query-immodules-2.0, and gtk-update-icon-cache</span>
            </div>
            <div class="seg">
              <strong class="segtitle">Installed Libraries:</strong>
              <span class="segbody">libgailutil.so, libgdk-x11-2.0.so, and
              libgtk-x11-2.0.so</span>
            </div>
            <div class="seg">
              <strong class="segtitle">Installed Directories:</strong>
              <span class="segbody">/etc/gtk-2.0,
              /usr/include/{gail-1.0,gtk-2.0,gtk-unix-print-2.0},
              /usr/lib/gtk-2.0, /usr/share/doc/gtk+-2.24.32,
              /usr/share/gtk-2.0,
              /usr/share/gtk-doc/html/{gail-libgail-util,gdk2,gtk2}, and
              /usr/share/themes/{Default,Emacs,Raleigh}</span>
            </div>
          </div>
        </div>
        <div class="variablelist">
          <h3>
            Short Descriptions
          </h3>
          <table border="0" class="variablelist">
            <colgroup>
              <col align="left" valign="top" />
              <col />
            </colgroup>
            <tbody>
              <tr>
                <td>
                  <p>
                    <a id="gtk-builder-convert" name=
                    "gtk-builder-convert"></a><span class="term"><span class=
                    "command"><strong>gtk-builder-convert</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    converts glade files into XML files which can be loaded
                    with GtkBuilder.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="gtk-demo" name="gtk-demo"></a><span class=
                    "term"><span class=
                    "command"><strong>gtk-demo</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    demonstrates <span class="application">GTK+ 2</span>
                    functionality and provides code for the examples.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="gtk-query-immodules-2.0" name=
                    "gtk-query-immodules-2.0"></a><span class=
                    "term"><span class=
                    "command"><strong>gtk-query-immodules-2.0</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    collects information about loadable input method modules
                    for <span class="application">GTK+ 2</span> and writes it
                    to standard output.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="gtk-update-icon-cache" name=
                    "gtk-update-icon-cache"></a><span class=
                    "term"><span class=
                    "command"><strong>gtk-update-icon-cache</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    creates mmap()able cache files for icon themes. Starting
                    with <span class="application">gtk+-2.24.24</span>, add
                    the flag <span class="quote">&ldquo;<span class=
                    "quote">--include-image-data</span>&rdquo;</span> to this
                    command, if you wish previous behavior, with image data
                    in the cache.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="libgdk-x11-2" name="libgdk-x11-2"></a><span class=
                    "term"><code class=
                    "filename">libgdk-x11-2.0.so</code></span>
                  </p>
                </td>
                <td>
                  <p>
                    contains functions that act as a wrapper around the
                    low-level drawing and windowing functions provided by the
                    underlying graphics system.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="libgtk-x11-2" name="libgtk-x11-2"></a><span class=
                    "term"><code class=
                    "filename">libgtk-x11-2.0.so</code></span>
                  </p>
                </td>
                <td>
                  <p>
                    contains functions that provide an API to implement
                    graphical user interfaces.
                  </p>
                </td>
              </tr>
            </tbody>
          </table>
        </div>
      </div>
      <p class="updated">
        Last updated on 2020-03-21 06:42:20 -0500
      </p>
    </div>
    <div class="navfooter">
      <ul>
        <li class="prev">
          <a accesskey="p" href="goffice010.html" title=
          "GOffice-0.10.46">Prev</a>
          <p>
            GOffice-0.10.46
          </p>
        </li>
        <li class="next">
          <a accesskey="n" href="gtk3.html" title="GTK+-3.24.16">Next</a>
          <p>
            GTK+-3.24.16
          </p>
        </li>
        <li class="up">
          <a accesskey="u" href="lib.html" title=
          "Chapter&nbsp;25.&nbsp;X Libraries">Up</a>
        </li>
        <li class="home">
          <a accesskey="h" href="../index.html" title=
          "Beyond Linux� From Scratch     (System V Edition) - Version 2020-04-02">
          Home</a>
        </li>
      </ul>
    </div>
  </body>
</html>
